SceneDataTransformer: support system and URL provided transformations by dprokop · Pull Request #1614 · grafana/scenes

dprokop · 2026-08-18T12:06:27Z

Adds support for system transformations in scenes.

System transformations are currently:

Provided by SceneDataTransformer parent (e.g. VizPanel, gated with applyPluginTransformations state flag)
Not saved in state.transformations
- read with getResolvedSystemTransformations
Discovered on SceneDataTransformer activation
Prepended before or appended after user transformations
Tagged with origin (i.e. plugin) and position (prepend, append)
Noop when system transformation provider throw

Also fixes variable interpolation dropping the operator function from object-form custom transformers.

🤖 Generated with Claude Code

📦 Published PR as canary version: 9.0.0--canary.1614.35114143706.0

✨ Test out this PR locally via:

npm install @grafana/scenes@9.0.0--canary.1614.35114143706.0
npm install scenes-app@9.0.0--canary.1614.35114143706.0
npm install @grafana/scenes-react@9.0.0--canary.1614.35114143706.0
# or 
yarn add @grafana/scenes@9.0.0--canary.1614.35114143706.0
yarn add scenes-app@9.0.0--canary.1614.35114143706.0
yarn add @grafana/scenes-react@9.0.0--canary.1614.35114143706.0

…rmer Adds SceneDataTransformer.setSystemTransformations so runtime transformations can be combined with the user configured ones without replacing them. Entries are tagged with an origin ('system' for panel provided, 'url' for url provided) and a position, are replaced per origin so different providers do not clobber each other, and can be filtered out via the exported isSystemTransformation guard before persisting or editing. Also fixes variable interpolation dropping the operator function from object form custom transformers. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Adds `PanelPlugin.setDataTransformations(supplier)`, so a panel can declare the transformations it needs in order to render its data — extracting fields out of a JSON column, reshaping long frames into wide ones — without giving up field overrides or the user's own transformation pipeline. Prepended transformations run before every user transformation and before field overrides, so the fields they produce are matchable by overrides and targetable by the user; appended ones run after all of them. The supplier is handed the query result frames, so it can branch on frame shape or `meta`, and it is evaluated inside the pipeline rather than pushed from a panel render, which keeps it free of a render -> setState -> data -> render loop. They are carried in `SceneDataTransformer.transformations` tagged `origin: 'system'` and filtered out of editors and save models by the `isSystemTransformation` guard, so they are never persisted, never editable, and dashboard JSON is unchanged. The transformations tab shows them as read-only rows badged `System`, and the editors replay the prepended stage so each row is configured against the field shape it will actually receive. Gated behind the `grafana.panelPluginTransformations` feature toggle. No existing panel changes behavior. Requires @grafana/scenes 8.15.0 (grafana/scenes#1614). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

…ransform state on every call to setSystemTransformations

…s, refactor & test coverage

gtk-grafana · 2026-08-18T19:24:31Z

@dprokop I made a few minor changes while working on the grafana implementation and PoCs

Fix: custom transforms calling setState on every call of setSystemTransformations: 78eb437
Fix: useDataTransformer wiping out system transforms (note adds new public setUserTransformations method): fdb7af0
Test: add coverage for interpolation 10c9c43
Chore: setSystemTransformations types d177c34
Fix: bug introduced in setUserTransformations refactor 3074fbb + regression test
Address question from Dom asking if we should remove url and rename system to plugin 00e5b54
Regression with null transformations in v1 dashboards: 456fa65 : SceneDataTransformer: support system and URL provided transformations #1614 (comment)

Other then that everything looks good, marking as ready for review

…transformations

cursor

Stale Bugbot comment from a previous run.

…ocess

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 77c6cec. Configure here.}

…sformer param

…er switching panels

gtk-grafana · 2026-09-15T11:26:01Z

I think we're finally pretty close here, if anyone has a few minutes for final review I would greatly appreciate it!

mdvictor

LGTM, left a couple of nits!

mdvictor

LGTM!

scenes-repo-bot-access-token · 2026-09-16T16:56:28Z

🚀 PR was released in v8.18.0 🚀

dprokop mentioned this pull request Aug 18, 2026

Dashboards: Support panel and URL provided transformations grafana/grafana#130914

Draft

chore: run prettier

7d1014e

gtk-grafana added release Create a release when this pr is merged minor Increment the minor version when merged labels Aug 18, 2026

gtk-grafana reviewed Aug 18, 2026

View reviewed changes

Comment thread packages/scenes/src/querying/SceneDataTransformer.ts Outdated

fix(SceneDataTransformer): prevent custom transforms from rewriting t…

78eb437

…ransform state on every call to setSystemTransformations

gtk-grafana mentioned this pull request Aug 18, 2026

chore: port logstable poc to new base branch grafana/grafana#130970

Closed

3 tasks

gtk-grafana reviewed Aug 18, 2026

View reviewed changes

Comment thread packages/scenes/src/querying/SceneDataTransformer.ts Outdated

gtk-grafana added 3 commits August 18, 2026 13:59

fix(useDataTransformer): prevent destruction of system transformation…

fdb7af0

…s, refactor & test coverage

test(SceneDataTransformer): cover interoplation coverage gap

10c9c43

chore(SceneDataTransformer): clean up types

d177c34

gtk-grafana marked this pull request as ready for review August 18, 2026 19:24

gtk-grafana requested a review from a team as a code owner August 18, 2026 19:24

gtk-grafana requested review from Sergej-Vlasov and harisrozajac and removed request for a team August 18, 2026 19:24

cursor Bot reviewed Aug 18, 2026

View reviewed changes

Comment thread packages/scenes/src/querying/SceneDataTransformer.ts

fix: setUserTransformations change bug

3074fbb

dprokop commented Aug 20, 2026

View reviewed changes

Comment thread packages/scenes/src/core/types.ts Outdated

gtk-grafana added a commit to grafana/grafana that referenced this pull request Aug 20, 2026

feat: define @grafana/data contract for grafana/scenes#1614 - system …

f8040d0

…transformations

gtk-grafana mentioned this pull request Aug 20, 2026

SystemTransformations: Contract grafana/grafana#131154

Closed

3 tasks

chore: remove url and rename system to plugin

00e5b54

gtk-grafana mentioned this pull request Aug 20, 2026

SystemTransformations: Implementation grafana/grafana#131174

Closed

chore: remove

7170dbf

gtk-grafana requested a review from torkelo September 11, 2026 13:15

cursor Bot reviewed Sep 11, 2026

View reviewed changes

Comment thread packages/scenes/src/components/VizPanel/VizPanel.tsx

Comment thread packages/scenes/src/components/VizPanel/VizPanel.tsx

torkelo reviewed Sep 14, 2026

View reviewed changes

Comment thread packages/scenes/src/components/VizPanel/VizPanel.tsx

torkelo reviewed Sep 14, 2026

View reviewed changes

Comment thread packages/scenes/src/components/VizPanel/VizPanel.tsx Outdated

torkelo reviewed Sep 14, 2026

View reviewed changes

Comment thread packages/scenes/src/querying/systemTransformations/systemTransformationTypes.ts Outdated

fix: remove unused, update docs, check if provider exists before repr…

77c6cec

…ocess

cursor Bot reviewed Sep 14, 2026

View reviewed changes

Comment thread packages/scenes/src/components/VizPanel/VizPanel.tsx

gtk-grafana added 2 commits September 14, 2026 08:01

chore(system-transforms): remove unused getSystemTransformations tran…

7d30c21

…sformer param

fix(system-transformations): clear transforms from stale provider aft…

900c38e

…er switching panels

gtk-grafana requested a review from torkelo September 14, 2026 13:41

fastfrwrd mentioned this pull request Sep 14, 2026

Table: ad-hoc transformations working branch grafana/grafana#132542

Closed

gtk-grafana requested review from harisrozajac and mdvictor September 15, 2026 11:24

torkelo previously approved these changes Sep 16, 2026

View reviewed changes

mdvictor reviewed Sep 16, 2026

View reviewed changes

Comment thread packages/scenes/src/querying/systemTransformations/systemTransformationProvider.ts Outdated

mdvictor reviewed Sep 16, 2026

View reviewed changes

Comment thread packages/scenes/src/components/VizPanel/VizPanel.tsx Outdated

mdvictor previously approved these changes Sep 16, 2026

View reviewed changes

chore: simplify narrowing with isSystemTransformationsProvider flag

846df9f

gtk-grafana dismissed stale reviews from mdvictor and torkelo via 846df9f September 16, 2026 15:08

chore(SystemTransformProvider): mark flags readonly

c710747

gtk-grafana added minor Increment the minor version when merged and removed major Increment the major version when merged labels Sep 16, 2026

mdvictor approved these changes Sep 16, 2026

View reviewed changes

gtk-grafana merged commit b07f8b2 into main Sep 16, 2026
21 checks passed

gtk-grafana deleted the panel-system-transformations branch September 16, 2026 16:22

scenes-repo-bot-access-token Bot added the released label Sep 16, 2026

Navigation Menu

SceneDataTransformer: support system and URL provided transformations - #1614

SceneDataTransformer: support system and URL provided transformations#1614
gtk-grafana merged 37 commits into
mainfrom
panel-system-transformations

dprokop commented Aug 18, 2026 •

edited by scenes-repo-bot-access-token Bot

Loading

Uh oh!

Uh oh!

Uh oh!

gtk-grafana commented Aug 18, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

gtk-grafana commented Sep 15, 2026

Uh oh!

Uh oh!

Uh oh!

mdvictor left a comment

Uh oh!

mdvictor left a comment

Uh oh!

Uh oh!

scenes-repo-bot-access-token Bot commented Sep 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

dprokop commented Aug 18, 2026 • edited by scenes-repo-bot-access-token Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gtk-grafana commented Aug 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

gtk-grafana commented Sep 15, 2026

Uh oh!

Uh oh!

Uh oh!

mdvictor left a comment

Choose a reason for hiding this comment

Uh oh!

mdvictor left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

scenes-repo-bot-access-token Bot commented Sep 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

dprokop commented Aug 18, 2026 •

edited by scenes-repo-bot-access-token Bot

Loading

gtk-grafana commented Aug 18, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading